Document Wayland opacity handling

diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c
index 60401a3835df7f05e95b2db972161ca5f8fb1f69..a4e2bbb5657bba3ac1959fe00e527dbcb4a0794b 100644 (file)
--- a/gdk/gdkwindow.c
+++ b/gdk/gdkwindow.c
@@ -10531,7 +10531,12 @@ gdk_window_configure_finished (GdkWindow *window)
  *
  * For toplevel windows this depends on support from the windowing system
  * that may not always be there. For instance, On X11, this works only on
- * X screens with a compositing manager running.
+ * X screens with a compositing manager running. On Wayland, there is no
+ * per-window opacity value that the compositor would apply. Instead, use
+ * `gdk_window_set_opaque_region (window, NULL)` to tell the compositor
+ * that the entire window is (potentially) non-opaque, and draw your content
+ * with alpha, or use gtk_widget_set_opacity() to set an overall opacity
+ * for your widgets.
  *
  * For child windows this function only works for non-native windows.
  *